---
title: Getting Started
description: Install and set up the CUA CLI
---

import { Tabs, Tab } from 'fumadocs-ui/components/tabs';
import { Callout } from 'fumadocs-ui/components/callout';

The Cua CLI is a command-line tool for managing your Cua cloud sandboxes. Create, start, stop, and connect to sandboxes directly from your terminal.

## Installation

<Tabs items={['macOS / Linux', 'Windows']}>
  <Tab value="macOS / Linux">
    ```bash
    curl -LsSf https://cua.ai/cli/install.sh | sh
    ```
  </Tab>
  <Tab value="Windows">
    ```powershell
    powershell -ExecutionPolicy ByPass -c "irm https://cua.ai/cli/install.ps1 | iex"
    ```
  </Tab>
</Tabs>

This installs [Bun](https://bun.sh) and the CUA CLI. Verify with:

```bash
cua --help
```

## Authentication

Login to your CUA account:

```bash
# Browser-based login
cua auth login

# Or with API key
cua auth login --api-key sk-your-api-key-here
```

Generate a `.env` file for your project:

```bash
cua auth env
```

## Quick Start

```bash
# Create a sandbox
cua create --os linux --size small --region north-america

# List sandboxes
cua list

# Open VNC in browser
cua vnc my-sandbox

# Stop a sandbox
cua stop my-sandbox
```

## Next Steps

- [Command Reference](/cli-playbook/commands) - Full list of available commands
